Azure Maps Geolocation Service (stable:1.0)

2025/10/15 • 1 new methods

Geolocation_GetIPToLocation (new)
Description :  The `Get IP To Location` API is an HTTP `GET` request that returns the ISO country/region code for a given IP address. Developers can use this information to block or modify content based on the geographical location from which the application is accessed.
Reference :  Link ¶

⚼ Request

GET:  /geolocation/ip/{format}
{
x-ms-client-id:
{
Description: Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be obtained from the [Azure Maps management plane Account API](/rest/api/maps-management/accounts). For more information on using Microsoft Entra ID security in Azure Maps, see [Manage authentication in Azure Maps](/azure/azure-maps/how-to-manage-authentication). ,
Required: False ,
}
string ,
api-version:
{
Description: Version number of Azure Maps API. ,
Required: True ,
}
string ,
format:
{
Description: Desired format of the response. Only `json` format is supported. ,
Required: True ,
}
string ,
ip:
{
Description: The IP address. Both IPv4 and IPv6 are allowed. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
countryRegion:
{
Description: The object containing the country/region information. ,
Required: False ,
}
{
isoCode:
{
Description: The IP address's 2-character country or region code ([ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html)). Note that IP addresses in ranges reserved for special purposes will return Null for country/region. ,
Required: False ,
}
string ,
}
,
ipAddress:
{
Description: The IP Address of the request. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}